
	!!!READ SETUP GUIDE FIRST TO GET THINGS SETUP!!!
	
	
/***********************************************************/
LOADER MODE FEATURES - USING ANIMTOOLS IN THE LOADER

load the animtools mod through the loader to have animtools load in 'loadermode'. see the setup guide on ways of doing this.
animtools in 'loadermode' can load positions using various ways and adds a few dialog actions and triggers.
animtools comes with some positions made by myself and other contributors from the sdt forum in the 'animtools_positions' folder. you can make your own positions using animtools in 'editmode' , see the 'user guide - editmode' for more info.
more positions can be found here: http://www.sdtmods.com/index.php?topic=3556.0


/************************/
DEFAULT LOADERMODE CONTROLS

	animtools has a few default keymappings that may be changed in the 'animtoolsV8settings.txt' file. these default keymappings may not be compatible with all keyboards.

	esc            - opens the menu when editmode keys are active
	f1             - reload the previous animtools positon (key 112)
	f2             - open up file selection box to load a position file. (key 113, this key may be changed in settings file under 'setloadfunctiontokey') , 
	f3			   - toggle to one of the default sdt positions
	f4			   - position togglepage button, cycles between pages of registered animtools positions
	f5,f6,f7 f8 f9 - quickloads an animtools position. by default these are mapped to categories of oral, tit, viginal, anal, and other. changing pages swaps the that kind of position according to who is dominant. (may be changed in settings file under 'customloadkey#')
	spacebar       - holding acts as an additional pushing force for body contact resistance; when it does it triggers the 'bodycontactspaceheldpush' dialog trigger
	f11 		   - loads a random position from the list of registered positions in the setting file
	*positions that are quickload key loaded need to be in the loader's 'Settings' folder

	
/*******************/
MODPAGE:
	upon the animtools mod being applied, a modpage is added to the loader tab. 
	this modpage contains a single 'load' button that pops up the file explorer to load an animtools position.
	depending on other mods loaded, it may not be the currently shown modpage. use the (<) (>) buttons on the loader tab to navigate through the modpages.
	
	
	
	
/******************/
DIALOG ACTIONS:

	[ANIMTOOLS_positionFileName] : loads the specified position from the loader's Settings folder
		animtools uses regular expression to parse actions. replace the above 'positionFileName' with a position name to use.
		example~ a position called "mydoggystyle.txt" is placed in the loader's settings folder, the following dialog line may be used to load it 
			first_dt:"okay, lets change positions [ANIMTOOLS_mydoggystyle]"

	*positions that are dialog loaded need to be in the loader's 'Settings' folder
		
		
	added a special replacement for animtools position paths defined in dialogs so you can go into folders, it is
	_slash5C_

	this will be replaced with a backslash, example:
	general:"load my cowgirl[^ANIMTOOLS_test_slash5C_ATV_AltCowgirl][COUGH]"

	this is to load a position that is 
	\Settings\animtools_positions\test\ATV_AltCowgirl.txt	
			
				
	[ANIMTOOLSRANDOM] : animtools will randomly choose a position that has been registered in the settings file	
				
	[ANIMTOOLSSETVOICECHAR0][ANIMTOOLSSETVOICECHAR1][ANIMTOOLSSETVOICECHAR2][ANIMTOOLSSETVOICECHAR3][ANIMTOOLSSETVOICECHAR4][ANIMTOOLSSETVOICECHAR5][ANIMTOOLSSETVOICECHAR6][ANIMTOOLSSETVOICECHAR7]
	to set which hunnie pop girl you want to change to for sounds. CHAR0 is no voice
			
	[ANIMTOOLSDISABLEHUNNIESOUNDS][ANIMTOOLSENABLEHUNNIESOUNDS]   
	enables and disables hunie voice feature
	
		
/**********************/		
DIALOG TRIGGERS:

	bodycontactspaceheldpush:   triggered when body contact enabled, and the spacebar is held down in a resistive area
	bodycontactspaceheldpush_tit, bodycontactspaceheldpush_vaginal, bodycontactspaceheldpush_anal, bodycontactspaceheldpush_other, called based on posiion type
			example dialog line usage~
				bodycontactspaceheldpush:"i can feel you deep inside me"
				bodycontactspaceheldpush:"i will say this when you are forcing yourself into my body"
	
	bodycontactspaceheldpushinhilt:   triggered when body contact enabled, she is being hilted, and the spacebar is held down in a resistive area
	bodycontactspaceheldpushinhilt_tit, bodycontactspaceheldpushinhilt_vaginal, bodycontactspaceheldpushinhilt_anal, bodycontactspaceheldpushinhilt_other, called based on posiion type
			example dialog line usage~
				bodycontactspaceheldpushinhilt:"oh my, why do you have to go so deep!?!"
				bodycontactspaceheldpushinhilt:"i will say this when you are pushing all the way in my body"

	bodycontacthilt: 	triggered on first hilt when body contact enabled
	bodycontacthilt_tit, bodycontacthilt_vaginal, bodycontacthilt_anal, bodycontacthilt_other, called based on posiion type
			example dialog line usage~
				bodycontacthilt:"holy shit you managed to get it all the way in?!?"
				bodycontacthilt:"i didn't think it would all fit in there!"
	
	bodyentered: 	triggered when the penis enters her body when body contact enabled
	bodyentered_tit, bodyentered_vaginal, bodyentered_anal, bodyentered_other, called based on posiion type
			example dialog line usage~
				bodyentered:"yeah put it in me"

	bodyexited: 	triggered when the penis exits her body when body contact enabled
	bodyexited_tit, bodyexited_vaginal, bodyexited_anal, bodyexited_other, called based on posiion type
			example dialog line usage~
				bodyexited:"yeah put it in me"		

	vigorousbodyexited: 	triggered when the penis exits her body after she has reached her vigour point (she winces), when body contact enabled
	vigorousbodyexited_tit, vigorousbodyexited_vaginal, vigorousbodyexited_anal, vigorousbodyexited_other, called based on posiion type
			example dialog line usage~
				vigorousbodyexited:"this is quite the vigourous pounding!"
				vigorousbodyexited:"oh wow this is rough!"
	
	vigorousbodyexitedrelax: triggered after a vigourous body contact, and her vigour level has returned to 0, allows a bit of time to settle			
	vigorousbodyexitedrelax_tit, vigorousbodyexitedrelax_vaginal, vigorousbodyexitedrelax_anal, vigorousbodyexitedrelax_other, called based on posiion type
				example dialog line usage~
				vigorousbodyexited:"Am I still gaping from that pounding?"
				vigorousbodyexited:"seeing if I will prolapse..?"
	
	inbody:		triggered when the penis is inside her body for a period of time (settings changeable), when body contact enabled
	inbody_tit, inbody_vaginal, inbody_anal, inbody_other, called based on posiion type
			example dialog line usage~
				inbody:"i can feel you inside my body"
				inbody:"you are in my body"	
		
	bodycontactloose: 	triggered when she no longer has resistance during body contact	
	bodycontactloose_tit, bodycontactloose_vaginal, bodycontactloose_anal, bodycontactloose_other, called based on posiion type
			example dialog line usage~
				bodycontactloose:"you loosened me right up!"
				bodycontactloose:"i'm all loosened up!"
				bodycontactloose:"i'm all loosened up!"
	
	cuminher:     triggered when body contact enabled, and he cums when his penis is in contact with her body	
	cuminher_tit, cuminher_vaginal, cuminher_anal, cuminher_other, called based on posiion type
			example dialog line usage~
				cuminher:"oh yeah pump your stuff into me!"
				cuminher:"i will say this when you are cumming into my body"

	bodycontactresistive: triggered when body contact resistance enabled, and he enters deeper than he has recently and hits resistance in her.
	bodycontactresistive_tit, bodycontactresistive_vaginal, bodycontactresistive_anal, bodycontactresistive_other, called based on posiion type
			example dialog line usage~
				bodycontactresistive:"Don't go so deep, it hurts!"
				bodycontactresistive:"Is my body too tight for you..?"

	bodycontactmovementvigour: triggered on lots of in body movement, acts similar to vanilla's vigour counter for throating (this specifically does not count any sort of vigour through resistance)
	bodycontactmovementvigour_tit, bodycontactmovementvigour_vaginal, bodycontactmovementvigour_anal, bodycontactmovementvigour_other, called based on posiion type
				
			
/**********************/		
DIALOG VARIABLES:			
	
	when animtools is not loaded, these are treated as 0's
	
	atv_active:		'1' indicates if animtools is loaded so position changing dialog lines can be used properly, allows dialogs to be flexible to support animtools loaded or not
			example dialog line usage~
				first_throat:"oh my, let me angle better if you are going to go that deep. .[ANIMTOOLS_ATV_laydownarmsprop]"{"check":{"atv_position":"==0","atv_active":"==1"}}
				general:"i'm bored, switch positions![ANIMTOOLS_ATV_AltCowgirl] there, that is better."{"check":{"atv_active":"==1"}}
			
	atv_position, atv_position2: 	indicates the position type of the current position, 0=oral, 1=tit, 2=vaginal, 3=anal, 4=other. can use atv_position2 to test ranges
			example dialog line usage~
				general:"i am sucking cock, using my mouth"{"check":{"atv_position":"==0"}}
				general:"you are tit fucking me"{"check":{"atv_position":"==1"}}
				general:"we are having vaginal sex"{"check":{"atv_position":"==2"}}
				general:"we are having anal sex"{"check":{"atv_position":"==3"}}
				general:"you are giving me anal or vaginal sex"{"check":{"atv_position":">1","atv_position2":"<4"}}
				general:"i don't know where you are putting your dick, this is the other user specific position"{"check":{"atv_position":"==4"}}
			
	atv_dominant, atv_dominant2:  indicates who is the dominant person in the position, 0=neutral, 1=her,2=him. (can be used to indicate who is doing the majority of the moving, or for things like she is on top, or she is a slave) can use atv_dominant2 to test ranges (which is really nor needed, just for consistency)
			example dialog line usage ~
				general:"I am in control here, i'll be doing to driving"{"check":{"atv_dominant":"==1"}}
				vigorous:"You are in control, fuck me as you wish"{"check":{"atv_dominant":"==2"}}
				vigorous:"We are enjoying some mostly consensual sexual activities where we are both somewhat in control"{"check":{"atv_dominant":"==0"}}
			
	atv_dominant_held, atv_dominant_held2: same as atv_dominant, but if the position is 0 and dominant is neutral, this will be set to depending on if the guy is holding her. useful if writing a dialog specifically for animtools and don't want to a lot of "held" checks.
				general:"I am in control here, i'll be doing to driving"{"check":{"atv_dominant_held":"==1"}}
				vigorous:"You are in control, fuck me as you wish"{"check":{"atv_dominant_held":"==2"}}
				vigorous:"This must be a neutral dominant position that is not oral, because then this would have been resolved to 1 or 2"{"check":{"atv_dominant_held":"==0"}}
	
	atv_position_name: indicates the name of the current position loaded
				general:"tested for doggy 6"{"check":{"atv_position_name":"ATV_doggy6_resistive"}}
				general:"tested for default position"{"check":{"atv_position_name":"ATV_defaultsdt"}}
				general:"testing for alternate default"{"check":{"atv_position_name":"ATV_facefuck"}}
	
	
	
	atv_inbodycontactloose: indicates she is currently at her minimum reistance for body contact, 0= not loose, 1=loose
				general:"Oh wow, you really loosened me right up!"{"check":{"atv_inbodycontactloose":"==1"}}
				general:"Am I tight enough for you?"{"check":{"atv_inbodycontactloose":"==0"}}
	
	
	atv_inbody: indictaes when penis is in her body, 0=not in body, 1=in body
				general:"Can you feel how wet I am?"{"check":{"atv_inbody":"==1"}}
				general:"Tired already? Must wear you out without me having to stop for air."{"check":{"atv_inbody":"==0"}}
	
	
	atv_curresist, atv_curresist2: indictaes how resistive her body is generally >2 is hard, <1 is loose
				general:"You are starting to stretch me out."{"check":{"atv_curresist":">1","atv_curresist2":"<3"}}
				general:"I'm so used, I bet I could fit a baseball bat in there.."{"check":{"atv_curresist":"<1"}}
				general:"You enjoy an ass this tight?"{"check":{"atv_curresist":">3"}}
	
	
	
	
	
	
	
/***********************************/
AUTOMATICALLY LOADED CHARACTER POSITION FILES
	
	animtool position files may be automatically loaded when a character folder is loaded by placing a specially named position file in that character folder.
		to do this, choose a position you wish to be loaded with a character, and rename the desired position to 'animtoolscharposition.txt'
		then place this position file in the desired character folder.
		after the animtools mod has been loaded, loading that character will apply the 'animtoolscharposition.txt' position.
	
	
	
/**********************************/
AUTO MODE FUNCTIONING AGAIN?

	modguy gave me some code to supposedly fix the automode with animtools. i threw it in and it seemed to work with my minimal testing strategies.
	hopefully it works xD

			